IMAGE_PARAM_METER

Description

This widget displays an image depending on the value of the parameter. Its is as an animation or 'filmstrip' for which the image is chosen depending on the value of the parameter: if the parameter value is equal to its minimum the first image is displayed. If the parameter value is equal to its maximum, the last image is displayed.

Common Attributes

See attributes common to all param widgets.

Specific Attributes
Name Value Type Default Value Description Comment V.

image

valid image file path

empty

Image file containing the list of images to display.

It is a single image containing a 'film strip' with many images. It can be vertical or horizontal, see the image_orientation attribute.

1.0

image_mask

valid image file path

'image' value with '_mask' postfix

Image file containing the list of images masks for the images.

This value is optional since by default it is generated from 'image'.

1.0

images_count

Positive integer

0

Number of images in the image file.


1.0

image_orientation

orientation

vertical

Orientation of the images in the image file.

This attribute is particularly useful to reuse existing images created for other skinning systems since there is no convention on the orientation of the images

1.0

Examples
<?xml version="1.0" encoding="utf-8" ?>
<SKIN language_version="1.0" background_image="bg.bmp" repeat="true">
   <IMAGE_PARAM_METER param_id="dsp.input1" image="analog_meter.bmp" images_count="127" image_orientation="horizontal" />
</SKIN>

(extract. The file contains 127 images)

analog_meter.bmp: 127 positions of the meter

(extract. The file contains 127 images)

analog_meter_mask.bmp:alpha mask for the 127 positions of the meter



(the pictures show the widget for different values of the parameter)

0%

50%

100%